Welcome
Welcome To CProxy Server V3.0

Thank you purchasing Computalynx CProxy Server software.

Please ensure that you fill in and return your registration card,

this will entitle you to free technical support and free future upgrades.

After installation please read the CProxy Server Configuration Section carefully.

Contents

What is CProxy Server

Installing CProxy Server

Starting CProxy Server

Main Window Overview

The File Menu

The Options Menu

The Protocol Options Menu

The Cache Options Menu

The Utilities Menu

The Security Menu

The View Menu and Log Window

Network Configuration

Browser Configuration

NNTP (News) Client Configuration

FTP Client Configuration

Telnet Client Configuration

Intranet Pages

Registation

Contact Details


Explain
What is CProxy Server

CProxy Server is designed soley as a 32 bit Proxy Server to enable many workstations to access the Internet via the HyperText  Transer Protocol ( HTTP). CProxy Server also support the File Transfer Protocol ( FTP) for transfering files to and from your workstation to other Internet Servers ), Network News Transfer Protocol (NNTP) for reading and posting articles in the newsgroups, Telnet for command line applications and  a port mapper to map most common services such as compuserve.

CProxy Server implements full a caching system for the HTTP protocol that keeps all items that are downloaded stored locally on the computer that CProxy Server is installed onto. If the same item is requested by any user within a specified time period then CProxy Server will supply the locally held copy thereby speeding up access to the item considerably and saving online costs by not having to dial the modem or ISDN adapter.

CProxy Supports all types of connections including Modems, ISDN Adaptors and leased line connections and offers excelent security features to protect your Local Area Network (LAN) from any other computer users on the Internet.

CProxy Server will allow many users to share the same modem or ISDN connection, whilst maintaining speed using the caching facilitys thereby reducing costs on additional lines and hardware.


Install
Installing CProxy Server

Windows 95

Floppy Disk

Insert your floppy disk into drive A, click on the START button and

select RUN.

Windows NT

Insert your floppy disk into drive A, and select FILE/RUN from

Program Manager.

In the box that appears type A:\SETUP.EXE to execute the installation program.

CD Rom

Select the Setup.exe Program from the CProxy Directory on the CD ROM Drive.

The installation wizard will then load , which will prompt you for the information required

to install CProxy properly.

Follow the on-screen prompts to install CProxy Server.

When you have finished the installation you will have a new program group containing the icons for

CProxy.

To configure CProxy Server, proceed to the configuration section of this manual.


Starting
Starting CProxy Server

Now that you have installed CProxy Server onto your system, there is a small amount of configuration required.

Before you can use CProxy Server on a network you must ensure that your Local Area Network (LAN) is configured correctly, if you are unsure about LAN configuration refer to the Network Configuration’ section.

Windows 95

Click on the START button and select the PROGRAMS folder, proceed to open the COMPUTALYNX APPLICATIONS

folder.Click on the CProxy entry.

Windows NT

Double click on the CProxy icon in the COMPUTALYNX APPLICATIONS group in Program Manager.

CProxy will appear as a icon in the tray. Double click with your left mouse button to activate the window.


Main Window
Main Window Overview

Cache capacity:

This graph represents the amount of disk space used as a percentage of the total amount allocated. As the cache fills the coloured bar will move horizontally across this graph. The coloured bar will change initially from green when the cache is empty to orange when it is 50% full and then red when it becomes 75% full. This is merely a visual indication for the user to show how full the cache is.

Cache hits:

This graph represents the number of items retrieved from the cache as a percentage of the total number of items requested. The coloured bar will change initially from red  to orange and then to green. This graph is refreshed every time CProxy is restarted and indicates the succesfull cache hit rate.

Items in cache:

This shows the total number of items currently in the cache directorys.

The status bar:

The status bar shows various information about connection states and connections in progress.

Icon Display

The Icons at the bottom of the window show the various modules loaded by CProxy Server.

   Remote Access Services DLL Loaded.

     HyperText Transfer Protocol DLL Loaded.

  File Transfer Protocol DLL Loaded.

   Network News Transfer Protocol DLL Loaded.

   Telnet Protocol DLL Loaded.

    Port Mapper DLL Loaded.

  Local Caching Enabled.

Display Timer

The display timer has two states. When CProxy Server is nor connected to the Internet or is using a permanent connection the timer displays the time of day. When you are using a modem or ISDN connection it will display the time of day when it is not connected to the Internet and the time to disconnect when you have a active connection to the Internet.


Main Menu
File Menu Operations

File/Flush cache

Will completely empty the cache. The cache should only be flushed if there are undesirable contents in the cache directory.

File/Install as service

This will set CMail server to run as a service, This means that when your computer is restarted CMail server will run automatically before you log-in. This can be usefull when CMail server is on a computer that acts as a server.

The changes will not take effect until CMail is restarted.

File/Remove Service

This will remove the service operation if it has been installed.

File/Exit

Exits from CProxy Server Completely. When you press the cross in the top of the main window CProxy Server continues running in the taskbar. Pressing File/Exit will actually exit the application.


Options Menu
The Options Menu

Options/Remote Access

This menu option will display the Remote Access Service (RAS) configuration screen.

Use Remote Access to connect to the Internet

Check this option if you wish to use a modem or dial up ISDN to connect to the Internet

Use Computalynx SCM to connect to the Internet

Check this option if you are using Computalynx Scheduler/Connection manager to connect to the Internet

PhoneBook Entry

Use the arrow on the right of this box to select the dial up networking entry that contains the settings to connect to your Internet Service Provider.

Username

This is the login name assigned to you by your Internet Service Provider

Password

This is the login password assigned to you by your Internet Service Provider

Disconnect After XXX mins of inactivity.

After connecting to your Internet Service Provider and retrieving pages CProxy Server will stay on line for this time period. During this period if another user request more pages from the Internet the current reset timer will be set to this value.

Modem Connection Timeout

This sets a safety timer when you request a connection to your Internet Service Provider, if the modem is still not connected after this time period CProxy Server will disconnect the modem and try again.

OK Button

Once you have filled in all the details press the OK button to save the settings

Cancel Button

If you have changed anything but do not wish to save it pressing the Cancel button will revert back to the settings you had prior to altering anything.


Protocol Options
The Protocol Options Menu

The Protocol Options menu allows you to setup the operational settings for the protocols used in CProxy Server.

HTTP Options

Log HTTP Events

When this checkbox is enabled any HTTP events will be shown in the realtime log window and recorded in the HTTP events log file.

Listen to which Port

This sets the port number on which the browsers will talk to CProxy Server on.

TCP/IP timeout value

When a item is requested from the Internet, This timer sets the maximum time that it takes to return it from the remote server.

FTP Options

Log FTP Events

When this checkbox is enabled any FTP events will be shown in the realtime log window and recorded in the FTP events log file.

Listen to which Port

This sets the port number on which the FTP clients will talk to CProxy Server on. Please note that this is not the FTP Proxy setting in your browser and is for use with clients such as WS FTP and FTP explorer.

TCP/IP timeout value

When a item is requested from the Internet, This timer sets the maximum time that it takes to return it from the remote server.

NNTP Options (News)

Listen to which Port

This sets the port number on which the news clients will talk to CProxy Server on.

TCP/IP timeout value

When a item is requested from the Internet, This timer sets the maximum time that it takes to return it from the remote server.

Relay Requests To

Enter the name of your Internet Service Providers News Server. CProxy Server will transparently relay all requests for news itmes to this server.

Log NNTP Events

When this checkbox is enabled any NNTP events will be shown in the realtime log window and recorded in the NNTP events log file.

Telnet Options

Log Telnet Events

When this checkbox is enabled any Telnet events will be shown in the realtime log window and recorded in the Telnet events log file.

Listen to which Port

This sets the port number on which the Telnet clients will talk to CProxy Server on. Telnet users will telnet into CProxy Server and then telnet again to the outside world.

TCP/IP timeout value

When a item is requested from the Internet, This timer sets the maximum time that it takes to return it from the remote server.

Port Mapper Options

This allows you to be able to configure a port on your server, which can be connected to another port on a host anywhere on the Internet, this remote host can then be accessed by anyone on your network.

Local Port

This will set up a local listening port. Please unsure that the port number is not used for any other service

Remote Port

This will tell CProxy Server the port number on the remote host to connect to. For example to map a port for Internet Relay Chat (IRC) enter 6667.

Remote Host

Enter the name of the remote host  e.g. www.remotehost.co.uk, on which the service is running.

Add map

Pressing  the add map button will commit the port map and make it instantly available.

Delete map

Pressing delete map after highlighting one of your existing maps will delete it and remove the service.

Log Mapper Events

When this checkbox is enabled any events on mapped ports will be shown in the realtime log window and recorded in the mapper events log file.

Exit

This will exit the port mapper module.


The Cache Options Menu

You can control the way that the caching feature of CProxy Server works by altering the settings found under this sub menu.

Standard Cache Options

Enable Local Caching

Selecting this option will either completely enable or disable the caching function.

Refresh every X days and X hours

This setting sets the amount of time that a item is used from the cache. After this period a connection is made even if the item requested is in the cache, The new item is down loaded and replaces the one in the cache.

Expire After X days

After a item has been in the cache for this period of days it is automatically deleted thereby making space for other items.

Maximum cache size

This will set the maximum amount of hard disk space that CProxy Server will use for caching.

Advanced  Cache Options

To have greater control over the way that CProxy Server's cache operates you can change the settings in the Advanced Cache Menu.

CGI Settings

The CGI Settings control the way that CProxy Server handles searches and query strings.

Cache 0 content length items

When items are downloaded from the Internet some do not implement a field that tells the browser how big the file is, these are typically hit counters and graphics that are generated by CGI programs. Enabling this option will tell CProxy Server to cache items that have a size but do not have a content-length header in the downloaded file.

Cache Query Items

When searches are performed on search engines or imagemaps are clicked the request is sent to the server as a query string. you can choose by setting this option if you want to cache these querys.

Exclude Sites From Cache

By entering sites into this section that can be totally excluded from the caching facility. These is very useful when you have sites that change very frequently and you need a 'live copy' every time you access the site.

Add Button

Type a site name to exclude from caching into the entry field above the buttons and press the add button. Now when a user requests any information from that site a Internet connection will be made and a new version of the page will be checked for.

All other sites will still be cached as normal. This has immediate effect.

Remove Button

Highlight a entry in the display window and click the remove button to delete the entry. This has immediate effect.

Exclude File Types

The Exclude file types section will allow you to choose what type of files are cached. By unchecking the file type you want to exclude, that file type will no longer be cached. You may wish to do this for downloaded files that are only used once and take up space in the cache if left there.

Upstream Proxy Requests

Upstream proxy request allow you to relay your requests to another proxy server. CProxy Server acts as a non-caching proxy server in this mode. all requests for data are passed to the server specified in the hostname field.

Relay Requests to next stage proxy server

Check this option if you want to use CProxy Server with another proxy server.

Hostname

The hostname or IP Address to relay requests to.

Port Number

The port number that the remote proxy server listens on for Http requests.


The Utilities Menu

The CProxy Server Utilities menu allows you to see at a glance operational statistics and manually connect or disconnect from your Internet Connection if you are using a dial up device.

CProxy Server Version

This displays the version of CProxy Server that you are running and if that version is a evaluation version.

Total Physical Memory

This displays the total amount of memory that is installed on your computer.

Physical Memory Available

This displays the total amount of memory available for CProxy Server to use. Memory managment of Windows95 or Windows NT will make more available if required.

Total Swap File Size

This displays the size of the paging file allocated by the operating system. This is also handled by the operation system on windows95 but can be adjusted on Windows NT.

Total Swap File Available

This displays how much of the swap file is available for applications to use. If this is less that ten megabytes on a Windows NT system it may be time to increase your swap file size. Please consult your Windows NT user manual.

Memory In Use

This is the total amount of physical memory in use.

Winsock Version

This displays the current version of the winsock.dll sockets implementation.

CProxy Cache Maximum

This displays the total size allocated to CProxy Servers hard disk cache.

CProxy Cache Size

This displays the total amount of cache space currently used by CProxy Server.

CProxy Cache Items

This displays the number of Items in the CProxy Servers Cache.

CProxy Max Users

This displays the total number of users allowed to access the Internet via CProxy Server.

CProxy Using Modem

This indicates if CProxy Server is set to use a dial up device.

CProxy FireWall

This will indicate if Station restrications have been imposed in the Security Options. CProxy is only considered to be a secure firewall if the Station Restrictions are operational.

Max Sockets

This displays the maximum number of sockets available to CProxy Server.

The Internet Connection Menu

Connect

Selecting Connect will start a connection to the Internet if you are using a dial up device.

Disconnect

Selecting Disconnect will disconnect a current connection to the Internet if CProxy Server made the connection. It will not disconnect a active connection if it was not connected by CProxy Server


The Security Menu

Admin Password

This will allow you to change the administration password. The password by default is set to asecret.

Old Password

Type the existing administrators password in this field.

New Password

Type the new password in this field.

Check Password

Re-type the new password in this field, you must type the new password exactly the same as before.

URL Restrictions

Using URL Restictions you can controll what sites your users are visiting.

You can have as many lists for different levels of restriction as you require. Only one can be in operation at any time.

The Window displays all lists currently set up on the CProxy Server.

Add Button

Click the add button to add a new list. The following dialog will appear.

List Name

Type the name that you wish to give your new list.

Internet Sites to Add

Type the name of the site you want to add to your list in the format www.computalynx.co.uk.

This will allow or deny any access to this complete site. Partial sites can be entered in the following formats.

www.computalynx.co.uk/~dave - will allow or prevent access to this users homepages

www.computalynx.co.uk/software/ - will allow or prevent access to any items stored under this directory.

Add Button

Pressing the add button will add your entry to the list and display it in the display window above.

Delete Button

To delete a entry from your list highlight the desired entry in the display window by clicking on it with your left mouse button and press the delete button.

Save Button

Pressing the save button will save any changes you have made to this list.

Discard Button

Pressing the discard button will exit without saving your changes.

Edit Button

The Edit button will allow you to edit a existing list. First select the list you wish to edit from the main display window and then press the edit button.

Remove Button

The Remove button will allow you to remove a existing list. First select the list you wish to edit from the main display window and then press the remove button.

Filter Operation Type

The filter operation box is a drop down list that allows you to select three states.

None

The selected list has no effect.

Allow Access

When allow access is selected the users are only allowed access to the sites on the active list.

Deny Access

When deny access is selected the users are only allowed access to the sites that are not on the active list.

Active List Name

This will display a drop down list of all of the lists you have created. You can select any list and set the operation type.

OK Button

This will exit the URL restrictions configuration and set active the settings you have made.

Cancel Button

This will exit the URL restrictions configuration and ignore the settings you have made.

Station Restictions

Station restrictions allow you to specify which workstations can access the Internet via CProxy Server and as importantly which workstations attached to the Internet can access your CProxy Server Software. The default operation is to allow any workstation to access the Internet via CProxy Server.

Activate Station Restrictions

Check this box is you wish to specify which workstations can access the CProxy Server.

Add Button

Click the add button to add a new list. The following dialog will appear.

List Name

Type the name that you wish to give your new list.

IP Address of accessing Station

Type the IP address of the workstation you want to add to your list in the format  192.168.0.1

This will allow access to this workstation. Partial networks can be entered in the following formats.

192.168.0.* - will allow or deny all workstations on the 192.168.0.x network and deny access to all others

Add Button

Pressing the add button will add your entry to the list and display it in the display window above.

Delete Button

To delete a entry from your list highlight the desired entry in the display window by clicking on it with your left mouse button and press the delete button.

Save Button

Pressing the save button will save any changes you have made to this list.

Discard Button

Pressing the discard button will exit without saving your changes.

Edit Button

The Edit button will allow you to edit a existing list. First select the list you wish to edit from the main display window and then press the edit button.

Remove Button

The Remove button will allow you to remove a existing list. First select the list you wish to edit from the main display window and then press the remove button.

Active List Name

This will display a drop down list of all of the lists you have created. You can select any list and set the operation type.

OK Button

This will exit the station restrictions configuration and set active the settings you have made.

Cancel Button

This will exit the station restrictions configuration and ignore the settings you have made.


The View Menu

The view menu will allow you to toggle on or off the displayed real time log window.

Display Area

The realtime log window allows you to set loggin options for different protocols and records the time events happen and which station requested various information fron the Internet.

Event Type

The Event type column displays what protocol was used for the requested operation.

Date & Time

The Date & Time Colomn displays the date and time that the requested item was required.

Reported Action

A brief discription of the full request made by the workstation.

CProxy Users

This displays a tree of accessing stations.

Logging Options

This allows you to select the Enable Logging option which will globally enable or disable all logging.

Protocol Options

This will allow you to toggle one of three states for each protocol.

View

Selecting view on any of the protocols will display the log file for that protocol.

Delete

Selecting Delete on any of the protocols will delete the log file for that protocol.

Trace

Selecting trace on any of the protocols will add this protocol to the realtime log window display.


Registering CProxy Server
Registration

When you first run CMail Server, you will be presented with the following window:

If you have already purchased CProxy Server:

Enter your User name and Registration code in the appropriate input boxes exactly as shown onyour registration details sheet.  Both the User name and the Registration code are case sensitive,so please ensure you type uppercase or lowercase as per the registration details sheet.

If you wish to evaluate CProxy Server:

Simply complete your User name (anything you wish, up to a maximum of 40 characters) and pressthe Evaluation button.  Please ensure that you leave the Registration code box empty.  Once pressed, CProxy Server will function for 14 days, after which you must register the product to continue using it.


Contacting Computalynx
Contacting Computalynx Ltd

If you need to contact Computalynx Ltd to place and order, for technical support or information onyour nearest distributor, or

any other products the following details should be useful.

Sales Dept

Main Contacts:

Les Beech

Jason Sanders

sales@computalynx.co.uk

Technical Support

Main Contacts:

Dave Trinder

Steve Bright

techsupp@computalynx.co.uk

Web Address

http://www.computalynx.co.uk

http://www.computalynx.net

Telephone

(+44) 1604 231437

Fax

(+44) 1604 231462

Computalynx Limited

Mobbs Miller House

Christchurch Road

NORTHAMPTON

NN1 5LL

United Kingdom


Setting up your Network
Configuring your Network for CMail Server

This is probably the most difficult part of getting CProxy  ‘up and running’.  You will need to ensure that your network is configured properly to use TCP/IP (the method by which  your machine’s will talk to each other), setting up the CProxy Server (your main machine) and getting the Client Machines (other machines on the network)  to ‘talk’ to the server is relatively easy.

First of all, ensure that TCP/IP  is running on all machines that will be using the system.  To do this correctly, refer to the documentation provided by your supplier of the TCP/IP software that you are using.

One thing you will need to specify to the TCP/IP software is an IP address.  Your main machine/Server will be given an IP address by your Internet Service Provider,  you will then need to give each machine on your network (including the Server) a seperate IP address. On the server there will be two IP addresses, one for the dialup adapter ( allocated by your Internet Service Provider) and one for the Ethernet Card ( from the addresses explained below).  There are a set of addresses set aside for LAN use .  These addresses are never allocated anywhere in the Internet, so you will not conflict with any valid IP addresses, and it is cheaper than obtaining several ‘real’ IP addresses.  The address group we would recommend using is the 192.168.0.x class C address,  x is usually 1-254 and can be thought as a unique reference number.

It is up to you how you allocate the addresses within this class C block, although it is general practice to number the machine running CProxy Server as 192.168.0.1 and the clients sequentialy upwards.

On the client machines, you will also need to set up a hosts file.  This provides a method of translating IP addresses into names, so you can have meaningful names instead of just dot notated addresses for your machines.  Refer to your operating system documentation to find out where the hosts file should reside.

A sample hosts file would need a entry something like the following:

192.168.0.1 	proxyserver

When you have assigned IP addresses to all machines using the mail system, check that the machines can ‘talk’ to each other using a utility called ping.  Go to a Dos Prompt and type:

ping  proxyserver

proxyserver  being one of the names in your hosts file.  Generally, the client machines will only need to know the host name and IP address for the machine running CProxy Server.  If you get a response from the other machine the network is configured properly.


Browser Configuration
Setting up a Browser

Once CProxy Server is installed and your network is configured you will need to tell your browsing  software how to talk to the Internet using the CProxy Server.

Microsoft Internet Explorer

To configure Microsoft Explorer 3.0, right click on the INTERNET icon on your desktop and select Properties from the menu, this will bring up the following window:

Click on the connection tab at the top of the window, then click the settings button from the proxy server section to display the window shown below.

Fill in the details as shown using the name that you created for your server in the hosts file as described in the network configuration section of this manual.

After entering these details click the apply button.

Netscape Navigator

To configure Netscape to use CProxy, run Netscape and select the menu option

OPTIONS/NETWORK Preferences. The following window will be displayed.

Click the Manual Proxy Configuration radio button and the press the view button.

Fill in the details as shown using the name that you created for your server in the hosts file as described in the network configuration section of this manual.


NNTP Client Configuration
Configuring a NNTP (News) Client

Once CProxy Server is set up and running you may want to configure a news client to access newsgroups on the Internet. There are many news readers and the following examples are a good example.

Netscape Navigator News

To configure Netscape news to use CProxy, run Netscape and select the menu option

OPTIONS/Mail and News Preferences. The following window will be displayed.

In the news section enter the name of the CProxy Server as assigned in the network configuration section of this manual.

Microsoft Internet News

To configure Microsoft Internet News, first run the application and select News/Options from the menu and click the server tab on the window that appears.

Press the Add button to add a news server.

In the news server section enter the name of the CProxy Server as assigned in the network configuration section of this manual.


FTP Clients
FTP Client Configuration

To upload and download files using the File Transfer Protocol you will need to configure a client to use CProxy Server, this differs from downloading files using a browser as you have the facility to both download and upload.

WS FTP Configuration

To configure WS FTP to use the CProxy Server first run the application

Press the advanced button to set additional settings needed to tell WS FTP how to use the CProxy Server.

Use FireWall

Check this option to tell WS FTP that it will be connecting via a firewall (CProxy Server)l

Firewall Information

Hostname

fill in the name assigned to the CProxy Server in the network configuration section of this manual

Username and Password

You do not need to fill in the username or password details.

Port

Set the port number to the same number set in the CProxy Server Options/Protocol Options/FTP options. This is set to port 1021 by default.

Firewall Type

Click the radio button to set the firewall type to Proxy OPEN.

You only need to complete this configuration once.

FTP Explorer

To configure FTP Explorer to use CProxy Server run the application and from the main menu select View/Options from the main menu. A window will appear, select the FireWall tab from this window.

Host

fill in the name assigned to the CProxy Server in the network configuration section of this manual

Port

Set the port number to the same number set in the CProxy Server Options/Protocol Options/FTP options. This is set to port 1021 by default.

Firewall Type

Click the radio button to set the firewall type to OPEN Hostname.

After setting the firewall options go to the connect screen using the menu option Tools/Connect. The following window will appear

Ensure that the Use Firewall box is checked. FTP Explorer will now connect to the Internet using CProxy Server


Configuring Telnet Clients
Configuring a Telnet Client

Telnet will allow character based communications to another server either locally or on the Internet. To use telnet via CProxy you must first connect to the CProxy Server and then connect to the remote server.

Windows Telnet

Run the Telnet application and select Connect from the menu. The following window will appear.

Press the connect button, a window will appear with a CProxy Telnet: prompt. To access another site simply type open followed by the name or IP address of the host you want to connect to.

After typing the name of the remote host its login prompt will appear.


Creating Intranet Sites
Creating an Intranet Site

A Intranet allows you to simulate an Internet session from within the confines of your own network, without having to access the Internet at all. This enables you to set up ‘pseudo’ web sites for users on your own network. This is particularly useful for sharing data  between your staff, such as telephone books, price lists and product specifications, which can be distributed to all users and  accessed by using a standard Internet browser.

This following section assumes you have some knowledge of HTML and creating web pages.

Creating an Intranet Site

Firstly create your desired HTML page, saving and naming it index.html

Next, go to and open the following directory:  Program Files/Computalynx/Cproxy/Cache/Intracache. Create a new folder within this directory, the name that you give to this folder will be the name that you use to access the pseudo web site via an Internet browser

e.g.  www.mywebsite.co.uk.

Lastly, if you have included images within your HTML page you will also need to include a folder containing these images, place this folder within the folder you created naming it accordingly. Please refer to the included files in the following directory for reference.

Program Files/Computalynx/Cproxy/Cache/Intracache/proxypages/notconnected.html etc.

Anyone within your network will now be able to access this site by typing the address within an Internet browser e.g. www.mywebsite.co.uk.

Please note this site will only be accessible by users on your network and not by anyone using the Internet outside your organisation.